<!DOCTYPE html>
<html lang="en">
<head>
  <meta charset="utf-8">
  <meta http-equiv="X-UA-Compatible" content="IE=edge,chrome=1">
  <title>给老婆大人的maven教程 - Even - A super concise theme for Hugo</title>
  <meta name="renderer" content="webkit" />
<meta name="viewport" content="width=device-width, initial-scale=1, maximum-scale=1"/>

<meta http-equiv="Cache-Control" content="no-transform" />
<meta http-equiv="Cache-Control" content="no-siteapp" />

<meta name="theme-color" content="#f8f5ec" />
<meta name="msapplication-navbutton-color" content="#f8f5ec">
<meta name="apple-mobile-web-app-capable" content="yes">
<meta name="apple-mobile-web-app-status-bar-style" content="#f8f5ec">


<meta name="author" content="幻想乡的云端" /><meta name="description" content="前言 老婆大人工作多年，却一直对maven的使用和原理一知半解。更可怕的是，我对maven的了解也是一知半解&amp;hellip;&amp;hellip; 于" /><meta name="keywords" content="Hugo, theme, even" />






<meta name="generator" content="Hugo 0.55.6 with even 4.0.0" />


<link rel="canonical" href="http://bailiyi.gitee.io/myblog/post/mavenlearn/" />
<link rel="apple-touch-icon" sizes="180x180" href="/myblog/apple-touch-icon.png">
<link rel="icon" type="image/png" sizes="32x32" href="/myblog/favicon-32x32.png">
<link rel="icon" type="image/png" sizes="16x16" href="/myblog/favicon-16x16.png">
<link rel="manifest" href="/myblog/manifest.json">
<link rel="mask-icon" href="/myblog/safari-pinned-tab.svg" color="#5bbad5">


<link href="/myblog/dist/even.c2a46f00.min.css" rel="stylesheet">
<link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/@fancyapps/fancybox@3.1.20/dist/jquery.fancybox.min.css" integrity="sha256-7TyXnr2YU040zfSP+rEcz29ggW4j56/ujTPwjMzyqFY=" crossorigin="anonymous">


<meta property="og:title" content="给老婆大人的maven教程" />
<meta property="og:description" content="前言 老婆大人工作多年，却一直对maven的使用和原理一知半解。更可怕的是，我对maven的了解也是一知半解&hellip;&hellip; 于" />
<meta property="og:type" content="article" />
<meta property="og:url" content="http://bailiyi.gitee.io/myblog/post/mavenlearn/" />
<meta property="article:published_time" content="2019-06-29T19:06:24&#43;08:00"/>
<meta property="article:modified_time" content="2019-06-29T19:06:24&#43;08:00"/>

<meta itemprop="name" content="给老婆大人的maven教程">
<meta itemprop="description" content="前言 老婆大人工作多年，却一直对maven的使用和原理一知半解。更可怕的是，我对maven的了解也是一知半解&hellip;&hellip; 于">


<meta itemprop="datePublished" content="2019-06-29T19:06:24&#43;08:00" />
<meta itemprop="dateModified" content="2019-06-29T19:06:24&#43;08:00" />
<meta itemprop="wordCount" content="3597">



<meta itemprop="keywords" content="" />
<meta name="twitter:card" content="summary"/>
<meta name="twitter:title" content="给老婆大人的maven教程"/>
<meta name="twitter:description" content="前言 老婆大人工作多年，却一直对maven的使用和原理一知半解。更可怕的是，我对maven的了解也是一知半解&hellip;&hellip; 于"/>

<!--[if lte IE 9]>
  <script src="https://cdnjs.cloudflare.com/ajax/libs/classlist/1.1.20170427/classList.min.js"></script>
<![endif]-->

<!--[if lt IE 9]>
  <script src="https://cdn.jsdelivr.net/npm/html5shiv@3.7.3/dist/html5shiv.min.js"></script>
  <script src="https://cdn.jsdelivr.net/npm/respond.js@1.4.2/dest/respond.min.js"></script>
<![endif]-->

</head>
<body>
  <div id="mobile-navbar" class="mobile-navbar">
  <div class="mobile-header-logo">
    <a href="/myblog/" class="logo">Even</a>
  </div>
  <div class="mobile-navbar-icon">
    <span></span>
    <span></span>
    <span></span>
  </div>
</div>
<nav id="mobile-menu" class="mobile-menu slideout-menu">
  <ul class="mobile-menu-list">
    <a href="/myblog/">
        <li class="mobile-menu-item">首页</li>
      </a><a href="/myblog/post/">
        <li class="mobile-menu-item">文章列表</li>
      </a><a href="/myblog/tags/">
        <li class="mobile-menu-item">标签</li>
      </a><a href="/myblog/categories/">
        <li class="mobile-menu-item">分类</li>
      </a>
  </ul>
</nav>
  <div class="container" id="mobile-panel">
    <header id="header" class="header">
        <div class="logo-wrapper">
  <a href="/myblog/" class="logo">Even</a>
</div>

<nav class="site-navbar">
  <ul id="menu" class="menu">
    <li class="menu-item">
        <a class="menu-item-link" href="/myblog/">首页</a>
      </li><li class="menu-item">
        <a class="menu-item-link" href="/myblog/post/">文章列表</a>
      </li><li class="menu-item">
        <a class="menu-item-link" href="/myblog/tags/">标签</a>
      </li><li class="menu-item">
        <a class="menu-item-link" href="/myblog/categories/">分类</a>
      </li>
  </ul>
</nav>
    </header>

    <main id="main" class="main">
      <div class="content-wrapper">
        <div id="content" class="content">
          <article class="post">
    
    <header class="post-header">
      <h1 class="post-title">给老婆大人的maven教程</h1>

      <div class="post-meta">
        <span class="post-time"> 2019-06-29 </span>
        
        
      </div>
    </header>

    <div class="post-toc" id="post-toc">
  <h2 class="post-toc-title">Contents</h2>
  <div class="post-toc-content">
    <nav id="TableOfContents">
<ul>
<li><a href="#前言">前言</a></li>
<li><a href="#1-maven能做什么">1 Maven能做什么</a>
<ul>
<li><a href="#1-1构建">1.1构建</a></li>
<li><a href="#1-2依赖管理">1.2依赖管理</a></li>
<li><a href="#1-3项目信息管理">1.3项目信息管理</a></li>
</ul></li>
<li><a href="#2-安装maven">2 安装Maven</a>
<ul>
<li><a href="#2-1-下载">2.1 下载</a></li>
<li><a href="#2-2-安装目录分析">2.2 安装目录分析</a></li>
<li><a href="#2-3-m2">2.3 ～/.m2</a></li>
<li><a href="#2-4-第一次运行">2.4 第一次运行</a></li>
</ul></li>
<li><a href="#3-入门使用">3 入门使用</a>
<ul>
<li><a href="#3-1-示例工程">3.1 示例工程</a></li>
<li><a href="#3-2-pom文件">3.2 POM文件</a></li>
<li><a href="#3-3-开发主代码">3.3 开发主代码</a></li>
<li><a href="#3-4-开发测试代码">3.4 开发测试代码</a></li>
</ul></li>
</ul>
</nav>
  </div>
</div>
    <div class="post-content">
      

<h1 id="前言">前言</h1>

<p>老婆大人工作多年，却一直对maven的使用和原理一知半解。更可怕的是，我对maven的了解也是一知半解&hellip;&hellip;
于是，在老婆大人“你先学会再教我”的指导思想下，这篇教程诞生了。
<code>本教程的目标人群：只用maven引过jar包的同学们</code></p>

<h1 id="1-maven能做什么">1 Maven能做什么</h1>

<blockquote>
<p>老婆：maven不就是用来打包的吗？再就是引引jar包什么的。</p>

<p>我：嗯&hellip;&hellip;你说的对！</p>
</blockquote>

<p>按照官方的说法，Maven是一款跨平台的项目管理工具。</p>

<p>这么说有点抽象哈，下面来说点具体的。</p>

<h2 id="1-1构建">1.1构建</h2>

<p>Maven可以帮助我们构建。</p>

<p>说构建，什么是构建呢？</p>

<p>回想一下，在没有Maven的时代，我们一天的工作是什么样的呢？</p>

<p>写完代码，编译一下，跑一下单元测试，没什么问题之后用IED打一个war包上传到服务器，部署到web容器里，然后写一份自测报告，转给测试的同事。如果出了bug，先本地重现一下，然后一步步找到bug，修好bug。然后再跑一下单元测试，再打包部署，再写报告…&hellip;</p>

<p>你看，咱们每天除了写代码之外，还需要**编译、单元测试、写文档、打包、部署 **等等，这些写代码之外的琐碎工作就是构建。</p>

<p>现在有了Maven，这些构建工作都可以一键完成，是不是很爽？</p>

<h2 id="1-2依赖管理">1.2依赖管理</h2>

<p>咱们做java开发的，少不了要引用各种各样的第三方jar包。在没有Maven的时代，我们一般要把这些jar包下载下来，放到工程里面。随着引入的jar包越来越多，版本冲突、垃圾依赖问题也会越来越严重。</p>

<p>有了Maven之后，我们只需要写一行代码，Maven就会自动下载jar包，并且解决潜在的冲突和重复依赖问题。</p>

<h2 id="1-3项目信息管理">1.3项目信息管理</h2>

<p>除了构建和依赖管理（也可说是打包和引jar包），Maven还可以帮我们管理项目信息，比如项目名、项目描述、项目版本、许可证等。这些东西以前分散在各处，找起来麻烦无比。现在Maven把这些信息管理起来了，节省了大量时间。</p>

<p>此外，Maven遵循“约定优于配置”原则，制定了一套项目目录、测试用例命名的规范。只要遵循这套规范，可以减少大量项配置，也减少了开发者之间的沟通成本。</p>

<h1 id="2-安装maven">2 安装Maven</h1>

<h2 id="2-1-下载">2.1 下载</h2>

<p>现在到了大家喜闻乐见的安装环节了！</p>

<p>不过咱们都是工作多年的资深码农，安装这种事相信你都懒得听。</p>

<p>所以，这里是Maven的官方下载地址：<a href="http://maven.apache.org/download.cgi">http://maven.apache.org/download.cgi</a></p>

<p>打开之后就是最新版的Maven下载地址。</p>

<p>下载列表中有Binary和Source两种包。其中Binary是编译好的文件，一般使用就用这种。Source是源代码，一般用于自己研究Maven源代码。</p>

<p>如果要下载历史版本的Maven，地址是<a href="http://maven.apache.org/docs/history.html">http://maven.apache.org/docs/history.html</a></p>

<p>需要注意的是，有Maven3和Maven2两个大版本。建议使用Maven3，<strong>不要用Maven2</strong>了。</p>

<h2 id="2-2-安装目录分析">2.2 安装目录分析</h2>

<p>Maven安装好之后，包含以下几个目录：bin、boot、conf、lib。</p>

<p>其中bin目录包含了Maven的运行脚本，咱们使用的Maven命令实际上就是在调用这些脚本。boot目录是Maven自己的加载器，咱们不用关心。比较需要关心的是conf和lib目录。</p>

<ul>
<li>conf目录包含了一个<strong>重要的文件settings.xml</strong>。这个文件是<strong>Maven的全局配置</strong>文件。一般情况下不建议直接修改这个文件。建议把该文件拷贝到～/.m2/目录下（～表示用户目录）修改，仅在用户范围内生效。</li>
<li>lib目录放置了所有Maven运行时需要的jar包，包括自带的和下载的。此外，该目录下还有<strong>Maven自带的超级pom</strong>，可以近似认为<strong>我们之后创建的所有pom都继承自这个超级pom</strong>，这个以后会详细介绍。</li>
</ul>

<h2 id="2-3-m2">2.3 ～/.m2</h2>

<blockquote>
<p>老婆：这个波浪号是什么？</p>

<p>我：呃，你是指“～”？</p>
</blockquote>

<p>刚刚咱们说到了～/.m2/目录，先说下这个“～”是个啥。</p>

<p>“～”在开发中一般指用户目录，这个目录是操作系统存放用户个人文件和配置的地方。比如win7系统，用户目录在C:\Users\xxx（xxx指当前用户的名字）,Linux和Mac系统直接在终端输入cd 回车，就能直接进入用户目录。</p>

<p>～/.m2目录下放了<strong>Maven的本地仓库</strong>，仓库的文件夹名称是repository。我们引入的jar包都存在这个本地仓库中。</p>

<p>除了本地仓库，我们一般会把Maven安装目录下的/conf/settings.xml拷贝到～/.m2/settings.xml。用来配置Maven的行为。这是一条<strong>最佳实践</strong>。</p>

<h2 id="2-4-第一次运行">2.4 第一次运行</h2>

<p>哔哔了这么久，终于可以跑一下看看效果了。心里还有点小激动呢～</p>

<p>在终端中（如果是windows，请打开&rdquo;运行&rdquo;对话框(Win+R),输入cmd 回车），执行以下代码：</p>
<div class="highlight"><div class="chroma">
<table class="lntable"><tr><td class="lntd">
<pre class="chroma"><code class="language-shell" data-lang="shell"><span class="lnt">1
</span></code></pre></td>
<td class="lntd">
<pre class="chroma"><code class="language-shell" data-lang="shell">mvn help:system</code></pre></td></tr></table>
</div>
</div>
<p>运行之后，可以看到maven自动下载了很多文件，最后输出了Java系统属性和环境变量。</p>

<p>恭喜你，你执行了一个真正的Maven任务！</p>

<h1 id="3-入门使用">3 入门使用</h1>

<p>一个没有Hello World的教程是一个没有灵魂的教程！</p>

<p>所以，本章咱们来写一个Hello World吧（手动微笑）</p>

<p>一般的教程多半会不借助任何工具从零开始搭建一个Maven工程，但是人生苦短，所以我们来下载一个现成的Maven工程吧。</p>

<h2 id="3-1-示例工程">3.1 示例工程</h2>

<p>就让咱们使用Spring Boot来写Hello World吧。</p>

<p>打开<a href="https://start.spring.io/，按下图选好基本配置，最后点击生成（Generate">https://start.spring.io/，按下图选好基本配置，最后点击生成（Generate</a> the project），我们就得到了一个使用Maven管理的java工程！</p>

<p><img src="../../static/img/sb1.png" alt="" /></p>

<h2 id="3-2-pom文件">3.2 POM文件</h2>

<p>解开下载的压缩包，打开之后大概长这样：</p>

<p><img src="../../static/img/sb2.png" alt="" /></p>

<p>这里面其他的文件我们暂且不管。先来看下pom.xml。</p>

<p>如你所知，<strong>pom.xml是Maven项目的核心</strong>，定义了项目的基本信息、构建方式、项目依赖等。</p>

<blockquote>
<p>老婆：这个我知道，平时引jar包就是在这呗。</p>

<p>我：哦。</p>
</blockquote>

<p>打开pom.xml，在文件的开头有这么几个元素：</p>
<div class="highlight"><div class="chroma">
<table class="lntable"><tr><td class="lntd">
<pre class="chroma"><code class="language-xml" data-lang="xml"><span class="lnt">1
</span><span class="lnt">2
</span><span class="lnt">3
</span><span class="lnt">4
</span><span class="lnt">5
</span></code></pre></td>
<td class="lntd">
<pre class="chroma"><code class="language-xml" data-lang="xml">	<span class="nt">&lt;groupId&gt;</span>com.example<span class="nt">&lt;/groupId&gt;</span>
	<span class="nt">&lt;artifactId&gt;</span>demo<span class="nt">&lt;/artifactId&gt;</span>
	<span class="nt">&lt;version&gt;</span>0.0.1-SNAPSHOT<span class="nt">&lt;/version&gt;</span>
	<span class="nt">&lt;name&gt;</span>Maven Hello World Project<span class="nt">&lt;/name&gt;</span>
	<span class="nt">&lt;description&gt;</span>Demo project for Spring Boot<span class="nt">&lt;/description&gt;</span></code></pre></td></tr></table>
</div>
</div>
<p>其中groupId、artifactId、version这三个元素可以说是文件中最重要的三个元素。这三个元素定义了一个项目的唯一坐标。我们引入第三方jar包时，实际也是通过这三个元素来指定引入哪个文件的。</p>

<p><strong>groupId定义了项目属于哪个组</strong>。这个组往往和项目所在的组织或公司相关。比如spring组织的Spring Boot项目，其groupId就是org.springframework.boot。而咱们这个项目是我个人用来写教程的，所以就叫com.example了（其实是懒得改）。</p>

<p><strong>artifactId定义了当前项目在组中的唯一ID</strong>。比如咱们这个工程的artifactId是demo。以后可能还有demo2，demo3项目（别学我这么命名…手动捂脸），这些项目都属于com.example组。</p>

<p><strong>version定义了当前项目的版本</strong>。其中SNAPSHOT意为快照，表示当前项目还在开发中，不是稳定版本。</p>

<p>name和description不是必须的。不过为了方便信息交流，还是建议写一下。</p>

<h2 id="3-3-开发主代码">3.3 开发主代码</h2>

<p>主代码就是咱们写业务逻辑的代码。主代码会被打包到最终的构件中（比如jar）。</p>

<p>Maven默认主代码位于src/main/java。所以，我们就在这个路径下写主代码。</p>

<p>为了方便，我把工程用idea打开，然后开始开发。</p>

<p>代码清单如下：</p>

<p><img src="../../static/img/hw1.png" alt="" /></p>

<p>好，代码写完了。这是一个简单的java类，只有一个sayHello方法。</p>

<h2 id="3-4-开发测试代码">3.4 开发测试代码</h2>

<p>和主代码不同，测试代码只在运行测试时用到，不会被打包。Maven默认的测试代码在src/test/java目录下，我们依样画葫芦，来创建一个测试文件。</p>

<p><img src="../../static/img/hw2.png" alt="" /></p>

<p>仍然是一个简单的java文件，在testSayHello方法上<strong>添加了@Test注解表示这是一个测试方法</strong>。</p>

<p>值得一提的是，我们要测试的方法是sayHello，所以测试方法就叫testSayHello。像这样使用test+目标方法名的命名方法是Junit的规范，现在虽然不强制要求的，但仍然是一个好习惯。</p>

<p>测试代码写好之后，我们就可以运行测试了。</p>

<p>cd到项目根目录下，执行以下命令：</p>
<div class="highlight"><div class="chroma">
<table class="lntable"><tr><td class="lntd">
<pre class="chroma"><code class="language-shell" data-lang="shell"><span class="lnt">1
</span></code></pre></td>
<td class="lntd">
<pre class="chroma"><code class="language-shell" data-lang="shell">mvn clean test</code></pre></td></tr></table>
</div>
</div>
<p>执行完毕之后,在输出中会看到以下信息：</p>

<p><img src="../../static/img/hw3.png" alt="" /></p>

<p>可以看到输出中有“Hello World of Maven !”，说明我们成功的执行了测试方法。</p>

<p>还可以看到Tests run: 1, Failures: 0, Errors: 0, Skipped: 0，意思是我们执行了一个测试方法，没有失败或跳过的测试方法。</p>

<p>##3.5 打包和运行</p>

<p>测试无误之后，就该打包了。</p>

<p>pom.xml中没有指定打包类型，所以会默认打成jar包。执行以下命令：</p>
<div class="highlight"><div class="chroma">
<table class="lntable"><tr><td class="lntd">
<pre class="chroma"><span class="lnt">1
</span></pre></td>
<td class="lntd">
<pre class="chroma">mvn clean package</pre></td></tr></table>
</div>
</div>
<p>执行完毕之后，在项目根目录的target目录下会生成demo-0.0.1-SNAPSHOT.jar文件。target目录是Maven默认的输出目录，如果目录不存在，Maven会自己建一个。</p>

<p>如果要把自己的jar包上传到本地仓库，可以执行：</p>
<div class="highlight"><div class="chroma">
<table class="lntable"><tr><td class="lntd">
<pre class="chroma"><span class="lnt">1
</span></pre></td>
<td class="lntd">
<pre class="chroma">mvn clean install</pre></td></tr></table>
</div>
</div>
<p>执行之后，我们就能在本地仓库看到咱们的jar包了，有图为证：</p>

    </div>

    <div class="post-copyright">
  <p class="copyright-item">
    <span class="item-title">Author</span>
    <span class="item-content">幻想乡的云端</span>
  </p>
  <p class="copyright-item">
    <span class="item-title">LastMod</span>
    <span class="item-content">
        2019-06-29
        
    </span>
  </p>
  
  
</div>
<footer class="post-footer">
      
      <nav class="post-nav">
        
        
      </nav>
    </footer>
  </article>
        </div>
        

      </div>
    </main>

    <footer id="footer" class="footer">
      <div class="social-links">
      <a href="mailto:your@email.com" class="iconfont icon-email" title="email"></a>
      <a href="http://localhost:1313" class="iconfont icon-stack-overflow" title="stack-overflow"></a>
      <a href="http://localhost:1313" class="iconfont icon-twitter" title="twitter"></a>
      <a href="http://localhost:1313" class="iconfont icon-facebook" title="facebook"></a>
      <a href="http://localhost:1313" class="iconfont icon-linkedin" title="linkedin"></a>
      <a href="http://localhost:1313" class="iconfont icon-google" title="google"></a>
      <a href="http://localhost:1313" class="iconfont icon-github" title="github"></a>
      <a href="http://localhost:1313" class="iconfont icon-weibo" title="weibo"></a>
      <a href="http://localhost:1313" class="iconfont icon-zhihu" title="zhihu"></a>
      <a href="http://localhost:1313" class="iconfont icon-douban" title="douban"></a>
      <a href="http://localhost:1313" class="iconfont icon-pocket" title="pocket"></a>
      <a href="http://localhost:1313" class="iconfont icon-tumblr" title="tumblr"></a>
      <a href="http://localhost:1313" class="iconfont icon-instagram" title="instagram"></a>
      <a href="http://localhost:1313" class="iconfont icon-gitlab" title="gitlab"></a>
      <a href="http://localhost:1313" class="iconfont icon-bilibili" title="bilibili"></a>
  <a href="http://bailiyi.gitee.io/myblog/index.xml" type="application/rss+xml" class="iconfont icon-rss" title="rss"></a>
</div>

<div class="copyright">
  <span class="power-by">
    Powered by <a class="hexo-link" href="https://gohugo.io">Hugo</a>
  </span>
  <span class="division">|</span>
  <span class="theme-info">
    Theme - 
    <a class="theme-link" href="https://github.com/olOwOlo/hugo-theme-even">Even</a>
  </span>

  

  <span class="copyright-year">
    &copy; 
    2017 - 
    2019
    <span class="heart">
      <i class="iconfont icon-heart"></i>
    </span>
    <span class="author">幻想乡的云端</span>
  </span>
</div>
    </footer>

    <div class="back-to-top" id="back-to-top">
      <i class="iconfont icon-up"></i>
    </div>
  </div>
  
  <script src="https://cdn.jsdelivr.net/npm/jquery@3.2.1/dist/jquery.min.js" integrity="sha256-hwg4gsxgFZhOsEEamdOYGBf13FyQuiTwlAQgxVSNgt4=" crossorigin="anonymous"></script>
  <script src="https://cdn.jsdelivr.net/npm/slideout@1.0.1/dist/slideout.min.js" integrity="sha256-t+zJ/g8/KXIJMjSVQdnibt4dlaDxc9zXr/9oNPeWqdg=" crossorigin="anonymous"></script>
  <script src="https://cdn.jsdelivr.net/npm/@fancyapps/fancybox@3.1.20/dist/jquery.fancybox.min.js" integrity="sha256-XVLffZaxoWfGUEbdzuLi7pwaUJv1cecsQJQqGLe7axY=" crossorigin="anonymous"></script>
<script type="text/javascript" src="/myblog/dist/even.26188efa.min.js"></script>








</body>
</html>
